package com.ruoyi.lock.service;

import com.ruoyi.lock.domain.APeriodicPassword;

import java.util.List;

/**
 * 周期性密码Service接口
 * 
 * @author ruoyi
 */
public interface IAPeriodicPasswordService {
    /**
     * 查询周期性密码
     * 
     * @param id 周期性密码主键
     * @return 周期性密码
     */
    public APeriodicPassword selectAPeriodicPasswordById(Long id);

    /**
     * 查询周期性密码列表
     * 
     * @param aPeriodicPassword 周期性密码
     * @return 周期性密码集合
     */
    public List<APeriodicPassword> selectAPeriodicPasswordList(APeriodicPassword aPeriodicPassword);

    /**
     * 查询房间指定MAC地址的周期性密码列表
     * 
     * @param deviceMac 设备MAC地址
     * @param homeId 房间ID
     * @param showExpired 是否显示过期密码
     * @return 周期性密码集合
     */
    public List<APeriodicPassword> selectPasswordsByMacAndHomeId(String deviceMac, Long homeId, Boolean showExpired);
    
    /**
     * 新增周期性密码
     * 
     * @param aPeriodicPassword 周期性密码
     * @return 结果
     */
    public int insertAPeriodicPassword(APeriodicPassword aPeriodicPassword);

    /**
     * 修改周期性密码
     * 
     * @param aPeriodicPassword 周期性密码
     * @return 结果
     */
    public int updateAPeriodicPassword(APeriodicPassword aPeriodicPassword);

    /**
     * 更新密码备注
     * 
     * @param id 密码ID
     * @param remarks 备注内容
     * @return 结果
     */
    public int updatePasswordRemarks(Long id, String remarks);
    
    /**
     * 批量删除周期性密码
     * 
     * @param ids 需要删除的周期性密码主键集合
     * @return 结果
     */
    public int deleteAPeriodicPasswordByIds(Long[] ids);

    /**
     * 删除周期性密码信息
     * 
     * @param id 周期性密码主键
     * @return 结果
     */
    public int deleteAPeriodicPasswordById(Long id);
    
    /**
     * 更新密码状态（定时任务调用）
     * 将过期的密码标记为已过期
     */
    public void updatePasswordStatus();
} 